package com.seal.commons.infrastructure.facade.store;

import com.seal.commons.exception.StoreException;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.IOException;
import java.io.InputStream;

/**
 * ClassName:StoreService <br/>
 * Function:  <br/>
 * Date:     2019-10-31 10:54 <br/>
 *
 * @author yong.huang
 * @see
 * @since JDK 1.8
 */
public interface StoreService {

    /**
     * 上传文件
     * @param file
     * @return
     */
    String upload(File file) throws StoreException;

    /**
     * 分组上传文件
     * @param bucketName
     * @param file
     * @return
     * @throws IOException
     */
    String upload(String bucketName, File file) throws StoreException;


    String upload(String localFilePath) throws StoreException;


    String upload(String bucketName, String filePath) throws StoreException;

    /**
     * web 上传文件
     * @param multipartFile
     * @return
     * @throws Exception
     */
    String upload(MultipartFile multipartFile) throws StoreException;


    /**
     * 分组上传文件
     * @param bucketName
     * @param multipartFile
     * @return
     * @throws IOException
     */
    String upload(String bucketName, MultipartFile multipartFile) throws StoreException;



    /**
     * 判断资源文件是否存在
     * @param bucketName 桶
     * @param resourcePath 资源文件路径
     * @return true: 存在，false: 不存在
     */
    boolean isExist(String bucketName, String resourcePath) throws StoreException;

    /**
     * 判断资源文件是否存在
     * @param resourcePath 资源文件路径
     * @return true: 存在，false: 不存在
     */
    boolean isExist(String resourcePath) throws StoreException;


    /**
     * 将资源文本读取到目标文件
     * @param resourcePath 资源文件路径
     * @param targetFile 目标文件
     */
    void read(String resourcePath, File targetFile) throws StoreException;


    /**
     * 将资源文本读取到目标文件
     * @param bucketName 桶
     * @param resourcePath  资源文件路径
     * @param targetFile 目标文件
     */
    void read(String bucketName, String resourcePath, File targetFile) throws StoreException;


    /**
     * 读取目标文件返回inputStream
     * @param resourcePath 文件路径
     * @return inputStream
     */
    InputStream readAsInputStream(String resourcePath) throws StoreException;

    /**
     *  读取目标文件返回inputStream
     * @param bucketName 桶
     * @param resourcePath 资源文件路径
     * @return
     */
    InputStream readAsInputStream(String bucketName, String resourcePath) throws StoreException;

    /**
     * 删除目标文件
     * @param resourcePath 资源文件路径
     */
    void deleteFile(String resourcePath) throws StoreException;


    /**
     * 删除目标文件
     * @param bucketName  桶
     * @param resourcePath 资源文件路径
     */
    void deleteFile(String bucketName, String resourcePath) throws StoreException;
}
